home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / vga2eps.zip / EPSPATCH.DOC < prev    next >
Text File  |  1992-04-15  |  3KB  |  72 lines
  1.                             15-04-1992
  2.  
  3.             EPSPATCH
  4.         ========
  5.  
  6. A program to modify the contents of an EPS file produced by VGA2EPS
  7.  
  8.  
  9. Author:
  10.  
  11. Alpo Värri, DSP Lab., Tampere University of Technology, Finland.
  12.  
  13.  
  14. Purpose:
  15.  
  16. The purpose of EPSPATCH is to provide a (crude) way to edit the contents
  17. of the EPS screen dump captured with VGA2EPS. The editing is implemented
  18. by letting the user to apply a patch image on top of the original one to
  19. the location of choice.
  20.  
  21.  
  22. Operation and usage:
  23.  
  24. The EPS files produced by VGA2EPS consist of a header, a small number of
  25. PostScript commands, the image encoded in hex format, and a small trailer.
  26. The hex image is organized as a matrix of 160 columns (each column
  27. representing four pixels) and 350 (640x350 image) or 480 (640x480 image)
  28. lines. The hex codes 0, 1,..., 9, A,..., F contain the pixel information
  29. in such a way that if the bit is not set, a pixel will be plotted on
  30. paper, i.e. 0 means a four pixels wide black horizontal line and F
  31. means that none of these pixels is printed. EPSPATCH reads the original
  32. input file and the patch file containing the new hex values, overwrites
  33. the image with the patch beginning from the line and column specified by
  34. the user, and writes the result to a new output file.
  35.  
  36. The command format is
  37.  
  38.  EPSPATCH FILEIN PATCHIN FILEOUT LINE COLUMN
  39.  
  40.  where FILEIN   is the EPS input file
  41.        PATCHIN  is the EPS patch to be applied
  42.        FILEOUT  is the output EPS file
  43.        LINE     is the first EPS line to be patched      (1-480)
  44.        COLUMN   is the first EPS column to be patched    (1-160)
  45.  
  46.  
  47. Application notes:
  48.  
  49. Three example patch files are included in the archive. The file BOX.PTC
  50. draws a 16x16 pixels wide black box. LINE.PTC draws a black horizontal
  51. line. POINTER.PTC draws a black pointer (like the mouse cursor in
  52. graphics mode) on a white background. The pointer patch was obtained
  53. from an EPS file made by VGA2EPS with the help of the SNIPPER utility
  54. published originally in PC Magazine and now available in SIMTEL20
  55. and other well equipped FTP sites. EPSPATCH was used to insert the
  56. text parts to the image AUTHOR.EPS. You may test the patches, for
  57. example, by giving the commands
  58.  
  59.     EPSPATCH AUTHOR.EPS  LINE.EPS AUTHOR2.EPS 1 1
  60.     EPSPATCH AUTHOR2.EPS LINE.EPS AUTHOR3.EPS 480 1
  61.  
  62. and by directing the file AUTHOR2.EPS to your PostScript printer. The
  63. image should now have a horizontal line on the first and last line of
  64. the image.
  65.  
  66. EPSPATCH assumes that the those lines which are longer than 68 characters
  67. belong to the hex image in the input EPS file. If you write your own
  68. comments to the EPS file which are longer than 68 characters, the output
  69. of EPSPATCH is probably not exactly what you wanted. If other characters
  70. than the above mentioned hex characters are present in the patch file,
  71. the PostScript interpreter of the laser printer will reject the page.
  72.